.\"
.\" FreeBSD pkg - a next generation package for the installation and maintenance
.\" of non-core utilities.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 8. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\"
.\"     @(#)pkg.8
.\"
.Dd April 3, 2018
.Dt PKG-UPDATING 8
.Os
.Sh NAME
.Nm "pkg updating"
.Nd display UPDATING entries of software packages
.Sh SYNOPSIS
.Nm
.Op Fl i
.Op Fl d Ar date
.Op Fl f Ar file
.Op Ar pkg-name ...
.Pp
.Nm
.Op Cm --case-insensitive
.Op Cm --date Ar date
.Op Cm --file Ar file
.Op Ar pkg-name ...
.Sh DESCRIPTION
The
.Nm
command scans the installed ports and show all UPDATING entries that affect one
of the installed ports.
Alternatively, a list of pkg-names could be passed.
.Sh OPTIONS
The following options are supported by
.Nm :
.Bl -tag -width file
.It Ar pkg-name ...
UPDATING entries for the named packages are displayed.
.It Fl i, Cm --case-insensitive
Matching against pkg-name case insensitive.
.It Fl d Ar date , Cm --date Ar date
Only entries newer than
.Ar date
are shown.
Use a YYYYMMDD date format.
.It Fl f Ar file , Cm --file Ar file
Defines a alternative location of the UPDATING
.Ar file .
.El
.Sh ENVIRONMENT
The following environment variables affect the execution of
.Nm :
.Bl -tag -width F1
.It Ev PORTSDIR
Location of the ports tree.
.El
.Sh FILES
See
.Xr pkg.conf 5 .
.Sh EXAMPLES
Shows all entries of all installed ports:
.Dl % pkg updating
.Pp
Shows all entries of all installed ports since 2012-01-01:
.Dl % pkg updating -d 20120101
.Pp
Shows all entries for all apache and mysql ports:
.Dl % pkg updating apache mysql
.Pp
Shows all apache entries since 2012-01-01:
.Dl % pkg updating -d 20120101 apache
.Pp
Defines that the UPDATING file is in /tmp and shows all entries of all
installed ports:
.Dl % pkg updating -f /tmp/UPDATING
.Sh SEE ALSO
.Xr pkg_printf 3 ,
.Xr pkg_repos 3 ,
.Xr pkg-repository 5 ,
.Xr pkg.conf 5 ,
.Xr pkg 8 ,
.Xr pkg-add 8 ,
.Xr pkg-alias 8 ,
.Xr pkg-annotate 8 ,
.Xr pkg-audit 8 ,
.Xr pkg-autoremove 8 ,
.Xr pkg-backup 8 ,
.Xr pkg-check 8 ,
.Xr pkg-clean 8 ,
.Xr pkg-config 8 ,
.Xr pkg-create 8 ,
.Xr pkg-delete 8 ,
.Xr pkg-fetch 8 ,
.Xr pkg-info 8 ,
.Xr pkg-install 8 ,
.Xr pkg-lock 8 ,
.Xr pkg-query 8 ,
.Xr pkg-register 8 ,
.Xr pkg-repo 8 ,
.Xr pkg-rquery 8 ,
.Xr pkg-search 8 ,
.Xr pkg-set 8 ,
.Xr pkg-shell 8 ,
.Xr pkg-shlib 8 ,
.Xr pkg-ssh 8 ,
.Xr pkg-stats 8 ,
.Xr pkg-update 8 ,
.Xr pkg-upgrade 8 ,
.Xr pkg-version 8 ,
.Xr pkg-which 8
